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V - Documentacao e Dispositivos 
V.l - Documentacao e Ajudas 

HCI, Cap. 11, Alan Dix 

Principles and Guidelines in Software UI Design, 
Cap. 17, Deborah Mayhew 



Melhor e Pior ? 
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Resumo da Aula Anterior 



• Testes com utilizadores 

• Fases do Teste 

• Analise dos dados por metodos 
estatfsticos 

- Teste t 

-Intervalos de Confianga 

-Chi Quadrado 
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Sumario 



• Importancia, caracterfsticas e guia 
de estilos dos manuais 

• Manuais convencionais 

• Princfpios e guias para manuais 

• Ajudas Interactivas 
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Importancia dos Manuais 



• Sao parte da Interface Pessoa Maquina 

(Experiencia de Utilizacao) 

• Primeiro contacto com a usabilidade do 
programa 

- Se o manual e facil de usar o programa 
tambem sera... 

• Influencia a compra do programa 

- Manual de boa qualidade leva a compra 

• Ajuda a refinar o Modelo Mental 

- Boa percepcao de como usar o sistema 
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Caracterfsticas de um Bom 


Manua 

uma Ma 


1 

IU 


• Um Bom manual nao substitui 


-Uma Boa explicagao no manual 




• Nao reduz numero de erros 






• Nem melhora a memorizacao das 


operacoes 




• Devem comecar a ser escritos 


no inicio 


do 


processo de desenvolvimento 






- Varios drafts 






- Escritores envolvidos no desenho 


da IU 




• Se dificeis de escrever 






- Provavelmente aplicacao dificil de 


aprender 


e 


de usar 
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Guia de Estilo 



• Conjunto de normas e convengoes 
que garantem a consistencia 

- Do estilo 

- Da terminologia e 

- Da organizacao 

• entre manuais de uma aplicagao ou 
de uma famflia de aplicagoes (ex. office) 

• Melhoram a usabilidade do manual ! 

(Tal como no caso das IUs) 
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Teste 




• A usabilidade de um manual deve 
ser testada incluindo: 


-Dificuldade de leitura 




-Testes de navegacao 
-Testes de compreensao 




• teste de um manual e um bom 
piloto para o teste da IPM 




-See dificil perceber o manual, talvez 
nao seja apenas um problema deste, 
mas tambem da IU 
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Tipos de Manuais 



• Manuais convencionais: 
-Tutoriais 

- Referenda (completa) 

- Referenda Rapida 
-Manual do Utilizador 

• Ajudas Interactivas 
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Manuais vs Utilizadores 



• Tutorials -> Novigos 

- Modulos de ensino sequenciais 

• Referenda -> Peritos 

- Procura rapida de informacao sintactica especifica 

• Referenda Rapida -> Peritos 

- Subconjunto das funcionalidades mais 
importantes e mais usadas (um cartao) 

• Manual do Utilizador -> Intermedios 

- Ensina a fazer tarefas no sistema 
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Niveis de Conhecimento 





















Alto 










Alto 








Alto 


Alto 
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Pacote de Manuais 



• Fornecer os 4 tipos de manuais com o 
sistema 

- Tutorial, Utilizador, Referenda e Referenda 
rapida 

- Permite evolucao de Novico -> Perito 

- Fazer 4 documentos separados (menos 
intimidante) 

• + Brochura que descreve o contexto em 
que cada manual deve ser usado 
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tagao e Ajuda; 
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PrJnCipJOS e GlliaS (Manual do Utilizador) 



• Facilidade de Navegagao 

• Facilidade de Aprendizagem 

• Facilidade de Leitura 

• Formatagao 
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Facilidade de Navegagao (1/2) 



• Organizar o nome dos capitulos e secgoes 
segundo os objectivos dos utilizadores 

- Enquadramento e Objectivos (Sim) 

- Arquitectura do Sistema (Nao) 

• Utilizadores nao precisam de saber coisas tecnicas 
para chegar ao que Ihes interessa no manual 

• Indice deve fornecer uma panoramica de 
alto nivel e nao uma lista exaustiva 

(e a primeira informacao que se le). 
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Facilidade de Navegacao (2/2) 



• Fornecer referencias tanto segundo os objectivos 
dos utilizadores como os nomes das operacoes 
(no indice) 

Utilizador Nome do Comando 

Documentos Formatar, 334-335 

Criar urn novo, 14-16 Novo, 14-16 

Formatar, 334-335 

• Separar os varios tipos de informacao e usar uma 
codificacao visual consistente para cada tipo 

- Motivagao - utilidade da funcionalidade 

- Conceitos - o que faz e qual o resultado final 

- Procedimentos - passos a seguir para usar 

- Exemplos 
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Lista de Conteudo 


- Navegagao (Exempio) 


• Formatagao 


Contents 


• Objectivos do 
utilizador 


"•,^_ , 


• Nao tecnico 

• N° de Niveis 


CIlrtnUR 2 

D=6nins the Bijhl Project 15 


• Espagos em 
branco 


CHAPTER 3 

System Behavior 21 

16 
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Exempio - indice 


de Capitulo 


• Introdugao 


♦ 




Chapter 1 


• Uso de fcone 


Introduction 


• N° de secgoes 




• Justificagao 


_; 
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Facilidade de Aprendizagem d/3) 



• Fornecer OS alicerces (usar ideias familiares) 

- Permite refinar o Modelo Mental 

• Introduzir passo a passo unidades de 
informagao pequenas e independentes 

- Ensinar a fazer algo nas primeiras paginas 

• Usar uma sequencia logica. 

- Nao referenciar informagao ainda nao 
introduzida. 

- Fornecer a informagao minima necessaria para 
executar uma tarefa simples. 
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Facilidade de Aprendizagem (2/3) 


• Dar exemplos 


• Apresentar ilustragoes (facilitam a explicacao) 


• Utilizar de modo consistente o espago e a 


localizagao de indicios visuais 


(cor, fontes, simbolos, etc., para separar info) 


• Evitar notagoes abstractas e formais 


(Usar exemplos e melhor) 
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Facilidade de Aprendizagem 0/3) 



• Levar o leitor a inferir (Geral -> Especifico) 

• Evitar antropomorfismos 

("o computador sabe o n° de TM" -> "pode obter 
o n° de TM") 

• Fornecer uma lista de situagoes de erro e 
do modo como estes podem ser resolvidos 

• Consistencia no estilo e terminologia 

- Ajudas Interactivas + mensagens de erro + 
componentes de dialogo 
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Facilidade de Leitura 



• Usar espagos em branco 

- zonas sem informagao - manual menos 
intimidante 

• Usar um nivel de escrita basico: 

- Paragrafos, Frases e Palavras simples e curtas 

- Voz activa e sem negativas 

- Ordenar as instrucoes cronologicamente 

- Nao hifenizar nem justificar a direita 

• Evitar termos muito especializados 
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Formatacao - Uso de Colunas 



• Uma coluna: 
-Facilidade de produgao 

- Preferido por leitores de documentos 
tecnicos 

-Suporta imagens maiores 

• Multiplas colunas: 

- Maior flexibilidade na colocagao das 
figuras 

-Linhas mais pequenas melhora a 
legibilidade do texto 
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Formatacao - Texto vs Figuras 



1° - Figura sumariza 
e suporta o texto 



2° - Figura introduz 
texto 



3° - Figura liga blocos 
de texto 
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Formatacao - Te xto vs Figuras 

• Figuras a parte E=E^ 



■Figuras desnecessarias a 
compreensao do texto 

■ Figuras como referenda 

■Figuras necessitam de 
processo de impressao 
diferentes (cor) 
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Ex. - Aspecto da Pagina 
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Alternativas 
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Exemplo - Conceito 


• Uso de figura 


▼ " — — 




• Imagem introduz 
texto 


,_..«„ ^_L^ --■;»-- ^ 




^SH^^ 


5^ 


• Formatagao da: 


1 W.lftlg \ / 




- Figura 


— \ \ / 




- Paragrafos 


^.ja^a,-*^^^ 




• Cabegalho 


ags:zi-:=f;;-=S3S;i: 


-~ 


• Espagos em branco 
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Exemplo - Detalhe 



Sequencia de 
acgoes mais 
detalhadas 

Texto introduz a 
figura 
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Exemplo - Novo Conceito 

• Tutorial 

• Figura liga texto 

• Uso de icone e 
barra 

• Formatagao da 
figura 
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HT] 



Exemplo - Directivas 






No Inicio do Manual 


• Icones 








• Exemplo 




^^^^;; : " > -.li-^-, 




• Formatacao da 


• «**..«* 






figura 


© 


iva* deata ratogoria nan sao eocBidersdas es. 






'J Boa Pratica: He directs 
desMiidsdas. 


lara »s ohJHtfivns do .* e iii„. (lev™ ser 








must.™ >i figura 1. 


I.'l fiut iiukIdh idiiiiw a.prEsiaitn(I(js. tnl conui 






lima direct iva 6 
llf quo a claasiflca 


aempre apresentada com o icone 




If^ 
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Exemplo - Directivas 
















• Exemplos 

• Caixa nas figuras 

• Uso de icones 

• Figuras suportam 
o texto 


7 


-m <■! ■-I--.I. ^ .IL..I .:: ir l -li ,1.-, 


", Ml,,'",' ,|: " V " :I '" 


ds. 




12/11/1991 

r/r/i 


/ 






[■'ijilirjl 2: .Nolai.-.H) (lite l;xi;!i:]i](« hirtsi 
m iilgiiina setyiii- ilcsN' Qiia di> Lstil" aj 


ados no Gnii de Estiln 
(sew diii-Hf lignras ((Hi 1 rcprp- 

■IIV.IS .l|iH^r!|l^n!:i^ II. 1 Sr'IT'illl, 




^^rr^J 


w 






'-« »s 


toMtiM 
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Estudo de Foss et 


al 82 

de Editor de Texto 


• Comparou dois manuais 


-Manual convencional 




• Organizado em torno d 


as funcionalidades do 


sistema 




• Usando linguagem teen 


ica 


• Usando notacoes formais 


- Manual modificado 




• Informagao organizada 


em torno de tarefas 


• Informacao basica segi 


ida de info mais 


avangada 




• Linguagem simples e menos tecnica 


• Muitos exemplos 
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Estudo 






• 44 estudantes (22+22) 


• Estudaram o manual (15 


a 30 


min) 


• Dados recolhidos: 






- N° de tarefas concluidas 






- Tempo gasto por tarefa (media) 




- N° de comandos para com 


jletar 


tarefa (media) 


- N° de consultas a ajuda on 


line 
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Resultados do estudo 







Modificado 






8.77 






16.00 






13.04 









• Utilizadores usando o manual modificado 
tiveram melhor desempenho (menos 10 min) 

• A qualidade do manual pode influenciar 
a aprendizagem do sistema 
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Ajudas Interactivas 



• Nao se perde nem estraga 

• Nao ocupa espaco fisico 

• A actualizacao e mais rapida e barata 

• E potencialmente mais facil de consultar 
(mecanismo de pesquisa) 

• Suporta o ensino interactivo 

• Pode-se controlar o nivel de detalhe da 
informacao 
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Requisitos da Ajuda 



• Disponibilidade 

- Deve estar disponivel em qualquer parte 
(incluir sempre uma ajuda em cada ecra 
principal) 

• Precisao e Cobertura 

- Esta de acordo com a versao do programa e 
cobre o comportamento actual do sistema 

- Descreve os comandos, assim como as tarefas 
mais comuns 

• Consistencia 

- No conteudo, terminologia e estilo 

• Entre as diferentes partes do sistema de ajuda e a 
documentacao em papel 
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Requisitos da Aj uda 

• Robustez 

- A ajuda nao deve estoirar com o programa 
(lancar noutra thread) 

- Algumas excepcoes podem lancar a ajuda 

• Flexibilidade 

- Adapta-se ao contexto e/ou a experiencia do 
utilizador (ex. Pesquisa e indice) 

• Discrete 

- Nao impede o utilizador de continuar o 
trabalho (MS clip) 

- Langar num ecra a parte (mais facil alternar) 
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Opgoes de Desenho 


de 


• Sensivel ao contexto versus um ponto 


entrada 




• Independente versus integrado 




• N° de niveis de detalhe, um ou multipl 


OS 


(novicos vs experientes) 




• Metodos de acesso (um ou varios) 




• Sequencial, hierarquico, em rede 




• Iniciativa do utilizador ou do sistema 




V.l - Documentagao e Ajudas 


38 



Tipos de Ajuda 



Menu da Janela 
Princi pal 

Options E'V 

Help Topics 



About Paint 



Botao do Titulo de 
Janela Secundaria 



Tool Tips 

jy m | j= Insert Tafale| | /C *" 




2} <l 
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Orientado a Tarefa 



File Edit Bookmark Option: Help 



IjJ Contents | £^ |„dex | #ft Search | 




I 



V Copying Files to a CD-R Disc for the First Time 
_ .opying Files to a CD-RW Disc for Ihe First Time 
£ Jopying Files to a DVD-RAM Disc for the First Time 

?" spying Methods 
■ it g d ID 
Adding and Erasing Files 

Understanding CD-R, CD-RW, and DVD -RAM Technology 
Troubleshooting 



l-ln|x| 



DirectCD prepares a CD-Recordable (CD-R), 

CD-ReWritable (CDt.RW), or DVD-RAM disc so you 

can directly copy files to it in much the same 

way that you copy files to a floppy disk or 

removable drive. You can then use Windows 

Explorer, or any other program that can read 

from and write to a drive letter, to copy files to a 

CD. 

You can also recover files from and repair 

damaged CDs, and undelete files, in certain 

circumstances. 

Date Last Updated: June 30, 2000 
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Orientado a Tecnologia 



■JIJIM I 






FHe Edit Bookmark Options Hekj 


^^m 




Helplopics Back | Print | | i> | 




CCJ Content* | Q, Index | #fc S««ch | 


About CD-ReWritable 

Technology 




* # Overview 
■■ ^ 'iiettmg Slarled 
m-m CgpyinoFilestoaCD 

+ t> Ejecting a CD 

'■£■ ^ Adotig and Eiasiig Fles 

- IjJ Ji,..J,i 1 i=.,Ji.yLL'l; LL- [v. at.JlJ 1 D-l AM l«,.',i,u,yy 




If you have a CD-Re Writable drive, you can use 
two types of CDs to make your own CDs: 
• CD-Pecordable (CD-R) discs 




d* 


f] CD-R Advantages 

£ ITi-RW Advantages 

i] About DVD -RAM Tedinotogii 

i\ Understanding Read and Vril* Speed! 

jj About Packet Writing 
1 About ISO 966] 


• CD-Re Writable CCD-RWJ discs 

CD-RW is a technology that, like CD-R, allows you 

to record information to a CD. The difference is 

that with CD-RW you can also erase the contents 
of a CD and rewrite new information tc it. 
Depending on how you want to use your CD, each 

CD type offers unique adian-ac.es. 

• CD-R Advantages 






• CD-RW Advantages 






Note: Only CD-RW and MultiRead CD-ROM 
drives can read and write data to CD-RW discs, 
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Ajuda Contextual 



directCDtt 



L« | SET.- | 

(Maaiimm bnglh: 11 oharadas) rj^s I 

Mtf;: I he label helps "o dslirauiih bslHser LUs. Hc | 

rE„bbCb„p„,l^^ 



Di-octCC is fo-i 



■ Formatling a C u-kw or uvu-KeccrJa ble Disc for the 
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Glossarios 



ludex | £sarch | Favorites Glossary | 



Absolute r " |! ""■ 
Absolute URL 

kctwc. lint 



ActiveX control 
Advanced full-texts 
ALI file 
Alias 

ALink 

ALink control 
Animated GIF 



£l 



zl 



fiefinitioin lot: Abiolute p. 



The 


full locator of 


a fie It 


-r ,r=.r 


the drive 


letter it is stored o 


, such a 


"<:■'. tt- 


e folder 


nan 


iB.subfulderna 


fuels), and file n 


ame. For 




■nple, C:\Offic 




-itiVllF 


.doc is tin 


ab 


olute oath, 
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|< ^jn]_x] 



Fidetity.com 



1 






Accepted Grants 
A roouiit.Si; ladu 






Incluida na Interface 



Client na ^^ 



Total Fles: 
Total Size (in KB) 
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Files Selected: 

See Selected [in KB]: 






Ga'hei Information 



Resolucao de Problemas 



B? Windows 2000 



Bock 



m 

Hide 

Contents foclex | Search | 
Type in (lie keyword to find: 



Forward Options Web Help 



(See alsctroublesnootinq t=: 

basic guidelines 

Client Service tor NetWare 

Display 

Hardware 

Internet Connections, ISP 

li< 



zi 



^Jnjxj 



Print Troubleshooter 
What problem ore you having? 

tf- My (HP) plotter won't print, 

f r*Ty network server printer won't print- 

f A printer I connect to through Transmission Control 
Prataco I/Internet Protocol [TCP/IP) won't print, 

■f A printer I connect to through a universal naming 
convention (UNC) server name won't print. 

f My local printer won't print. 

Nest > I 
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FAQ 



File Edit Bookmark Options Help 



°- i j. i i» r 



Frequently Asked Questions 

For more complete and up-to-date FAQs, please sit the WinZipi) w 






How do I use WinZip to e-mail archives? 

Why sren\ WinZi; working for me? 






Related Topic 



Windows Shell Integration Examples 
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Pesquisa na Ajuda 














Help Topics: WinZip® Help File 




ms 


Contents | Index Find | 




Ivpe the ^rdMj™ want to find 
adding! 


'I 


Clear 1 


2 Select some matching words to nanowyoui search 




Option, 1 




adding 

Adding 


H 


Find Similar... | 




Find Now | 


Rebuild... | 




3 Click a topic, then click Display 






Adding a File in an Archive with the Diao and Drop In 

AddmgFilestoanArch.ve 

Brief Tutorial -Adding File;: to an Archive 

Briel Tutorial -Additional Features 

Biiel Tutorial - Centenis 




"d 








25 Topic, Found | | All W ds. 


egin.Au 


o. Pause 










Display | 


Print. 


| c «., | 
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Assistentes 



Automatizacao de tarefas atraves de dialogos 

com o utilizador 

Conjunto de paginas desenhadas em Janela 

Secundaria 



WinZip Wizard - Select Activity 




What do you want to do? 



Click on the activity ^t 
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Conclusdes 



• Manuais convencionais e Ajudas Interactivas 

• Principios e guias para manuais 

• Importante caracterizar o tipo de manual, a 
sua funcao e o publico alvo 

• Garantir consistencia entre a IU e os manuais 
e as ajudas interactivas (modelo conceptual) 

• O grande desafio e suportar todas as 
necessidades de documentacao: 

- Novicos precisam de perceber o "como" e o "que" 

- Utilizadores regulares precisam de relembrar 
procedimentos 

- Peritos querem encontrar procedimentos mais 
eficientes 



- Documentacao e 



Ajudas 



Exemplos 



• Live Manuals ( ver video ) 

- www.livemanuals.com 

• Online help - Discussion articles 

-http://deyalexander.com/resources/ 
online-help.html 

• Usable Help (varios exemplos de Helps 
online) 

-http://www.g2meyer.com/usablehelp/ 
gallery/index. html 
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Proxima Aula 



• Dispositivos de Entrada de Dados 

- Texto 

• Teclados, Escrita a mao, Fala 
-Coordenadas 

• Ratos e derivados 

• Tabletes 

• 3D 

- Novos dispositivos 

• Ler 

-HCI, Cap. 2 (pags. 59-97), Alan Dix 
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